о поставщике WSMan

您所在的位置：网站首页 › set-item wsman › о поставщике WSMan

о поставщике WSMan

2024-03-05 23:32| 来源: 网络整理| 查看: 265

about_WSMan_Provider Статья 04/13/2023 Имя поставщика

WSMan

Диски

WSMan:

Краткое описание

Предоставляет доступ к сведениям о конфигурации веб-служб для управления (WS-Management).

Подробное описание

Эта информация относится только к PowerShell, работающей в Windows.

Поставщик WSMan для PowerShell позволяет добавлять, изменять, очищать и удалять данные конфигурации WS-Management на локальных или удаленных компьютерах.

Поставщик WSMan предоставляет диск PowerShell со структурой каталогов, соответствующей логической группировке параметров конфигурации WS-Management. Эти группировки называются контейнерами.

Начиная с Windows PowerShell 3.0 поставщик WSMan был обновлен для поддержки новых свойств конфигураций сеансов, таких как OutputBufferingMode. Конфигурации сеанса отображаются как элементы в каталоге подключаемого WSMan: модуля диска, а свойства отображаются как элементы в каждой конфигурации сеанса.

Поставщик WSMan поддерживает следующие командлеты, описанные в этой статье.

Get-Location Set-Location Get-Item Get-ChildItem New-Item Remove-Item

Примечание.

Команды на WSMan: диске можно использовать для изменения значений новых свойств. Однако нельзя использовать WSMan: диск в PowerShell 2.0 для изменения свойств, представленных в Windows PowerShell 3.0. Хотя ошибка не создается, команды не эффективны для изменения этих параметров, используйте диск WSMan в Windows PowerShell 3.0.

Организация WSMan: Drive

Клиент. Вы можете настроить различные аспекты клиента WS-Management. Сведения о конфигурации хранятся в реестре.

Служба. Вы можете настроить различные аспекты службы WS-Management. Сведения о конфигурации хранятся в реестре.

Примечание.

Конфигурация службы иногда называется конфигурацией сервера.

Оболочка. Вы можете настроить различные аспекты оболочки WS-Management, например параметр, позволяющий разрешить удаленный доступ к оболочке (AllowRemoteShellAccess) и максимальное число одновременных пользователей (MaxConcurrentUsers).

Прослушиватель: вы можете создать и настроить прослушиватель. Прослушиватель — это служба управления, которая реализует протокол WS-Management для отправки и получения сообщений.

Подключаемый модуль: подключаемые модули загружаются и используются службой WS-Management для предоставления различных функций. По умолчанию PowerShell предоставляет три подключаемых модуля:

Подключаемый модуль пересылки событий. Подключаемый модуль Microsoft.PowerShell. Подключаемый модуль поставщика инструментария управления Windows (WMI). Эти три подключаемых модуля поддерживают пересылку событий, конфигурацию и доступ WMI.

ClientCertificate: вы можете создать и настроить сертификат клиента. Сертификат клиента используется при настройке клиента WS-Management для использования проверки подлинности сертификата.

Иерархия каталогов поставщика WSMan

Иерархия каталогов поставщика WSMan для локального компьютера выглядит следующим образом.

WSMan:\localhost --- Client --- Service --- Shell --- Listener ------ --- Plugin ------ Event Forwarding Plugin --------- InitializationParameters --------- Resources ------------ Security ------ Microsoft.Powershell --------- InitializationParameters --------- Resources ------------ Security ------ WMI Provider --------- InitializationParameters --------- Resources ------------ Security --- ClientCertificate

Иерархия каталогов поставщика WSMan для удаленного компьютера совпадает с локальным компьютером. Однако для доступа к параметрам конфигурации удаленного компьютера необходимо подключиться к удаленному компьютеру с помощью Подключение-WSMan. После подключения к удаленному компьютеру имя удаленного компьютера отображается в поставщике.

WSMan:\ Навигация по WSMan: Drive

Эта команда использует Set-Location командлет для изменения текущего расположения на WSMan: диск.

Set-Location WSMan:

Чтобы вернуться к диску файловой системы, введите имя диска. Например, введите.

Set-Location C: Переход к расположению удаленного хранилища системы

Эта команда использует Set-Location команду, чтобы изменить текущее расположение на корневое расположение в расположении удаленного хранилища системы. Используйте обратную косую черту \ или косую косую черту / , чтобы указать уровень WSMan: диска.

Set-Location -Path WSMan:\SERVER01

Примечание.

Приведенная выше команда предполагает, что подключение к удаленной системе уже существует.

Отображение содержимого WSMan: диск

Эта команда использует Get-Childitem командлет для отображения хранилищ WS-Management в расположении хранилища Localhost.

Get-ChildItem -path WSMan:\Localhost

Если вы находитесь на WSMan: диске, можно опустить имя диска.

Эта команда использует Get-Childitem командлет для отображения хранилищ WS-Management на удаленном компьютере в расположении хранилища SERVER01.

Get-ChildItem -path WSMan:\SERVER01

Примечание.

Приведенная выше команда предполагает, что подключение к удаленной системе уже существует.

Задание значения элементов в WSMAN: диск

Командлет можно использовать Set-Item для изменения параметров конфигурации на WSMAN диске. В следующем примере устанавливается значение TrustedHosts для принятия всех узлов с суффиксом "contoso.com".

# You do not need to specify the -Path parameter name when using Set-Item. PS WSMAN:\localhost\Client> Set-Item .\TrustedHosts -Value "*.contoso.com"

Командлет Set-Item поддерживает дополнительный параметр -Concatenate , добавляющий значение вместо изменения. В следующем примере будет добавлено новое значение "*.domain2.com" к старому значению, хранящееся в TrustedHost:

Set-Item WSMAN:\localhost\Client\TrustedHosts *.domain2.com -Concatenate Создание элементов в WSMAN: диск Создание нового прослушивателя

Командлет New-Item создает элементы на диске поставщика. У каждого поставщика есть различные типы элементов, которые можно создать. На диске можно создать прослушиватели, настроенные WSMAN: для получения и реагирования на удаленные запросы. Следующая команда создает новый прослушиватель HTTP с помощью командлета New-Item .

New-Item -Path WSMan:\localhost\Listener -Address * -Transport HTTP -force Создание подключаемого модуля

Эта команда создает (регистрирует) подключаемый модуль для службы WS-Management.

New-Item -Path WSMan:\localhost\Plugin ` -Plugin TestPlugin ` -FileName %systemroot%\system32\WsmWmiPl.dll ` -Resource http://schemas.dmtf.org/wbem/wscim/2/cim-schema ` -SDKVersion 1 ` -Capability "Get","Put","Invoke","Enumerate" ` -XMLRenderingType text Создание записи ресурса

Эта команда создает запись ресурса в каталоге ресурсов TestPlugin. Эта команда предполагает, что TestPlugin создан с помощью отдельной команды.

New-Item -Path WSMan:\localhost\Plugin\TestPlugin\Resources ` -ResourceUri http://schemas.dmtf.org/wbem/wscim/3/cim-schema ` -Capability "Enumerate" Создание новой записи безопасности для ресурса

Эта команда создает запись безопасности в каталоге безопасности Resource_5967683 (определенный ресурс). Эта команда предполагает, что запись ресурса была создана с помощью отдельной команды.

$path = "WSMan:\localhost\Plugin\TestPlugin\Resources\Resource_5967683" New-Item -Path $path\Security ` -Sddl "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GWGX;;;WD)" Создание сертификата клиента

Эта команда создает запись ClientCertificate , которая может использоваться клиентом WS-Management. Новый ClientCertificate будет отображаться в каталоге ClientCertificate как "ClientCertificate_1234567890". Все параметры являются обязательными. Издатель должен быть отпечаток сертификата издателей.

$cred = Get-Credential New-Item -Path WSMan:\localhost\ClientCertificate ` -Issuer 1b3fd224d66c6413fe20d21e38b304226d192dfe ` -URI wmicimv2/* ` -Credential $cred; Создание нового параметра инициализации

Эта команда создает параметр инициализации с именем testparametername в каталоге InitializationParameters. Эта команда предполагает, что "TestPlugin" создан с помощью отдельной команды.

New-Item -Path WSMan:\localhost\Plugin\TestPlugin\InitializationParameters ` -ParamName testparametername ` -ParamValue testparametervalue Динамические параметры

Динамические параметры — это параметры командлета, добавленные поставщиком PowerShell, и доступны только в том случае, если командлет используется на диске с поддержкой поставщика.

Строка адреса

Задает адрес, для которого был создан данный прослушиватель. Может иметь следующие значения:

Литеральная строка "*". (Дикий карта символ (*) делает команду привязкой всех IP-адресов ко всем сетевым адаптерам.) Литеральная строка "IP:", за которой следует допустимый IP-адрес в формате IPv4 с точками десятичного разряда или в клонируемом формате IPv6 с шестнадцатеричным форматом. Литеральная строка "MAC:", за которой следует MAC-адрес адаптера. Например: MAC:32-a3-58-90-be-cc.

Примечание.

Значение адреса задается при создании прослушивателя.

Поддерживаемые командлеты New-Item Перечисление возможностей

При работе с подключаемыми модулями этот параметр указывает операцию, поддерживаемую в этом универсальном идентификаторе ресурса (URI). Необходимо создать одну запись для каждого типа операции, которую поддерживает URI. Можно указать любые допустимые атрибуты для данной операции, если операция поддерживает ее.

К этим атрибутам относятся ПоддержкаFiltering и SupportsFragment.

Создание. Операции создания поддерживаются в URI. Атрибут SupportFragment используется, если операция Create поддерживает концепцию. Атрибут SupportFiltering недопустим для операций create и должен иметь значение False.

Примечание.